
OSF CLI Go
io.github.edithatogoPublished by GitHub account edithatogov0.3.2Updated Oct 24, 2026
Read-only MCP tools for authenticated Open Science Framework projects and files.
Overview
A local stdio MCP server exposing read-only tools for authenticated Open Science Framework projects, files, preprints and DOI lookups.
- What you can do
- Identify the authenticated OSF account and list or inspect projects and their components, including contributors and OSF Storage files (listing only). Search OSF literature and preprints with bounded limits, returning structured JSON with IDs, titles, abstracts, keywords, year and URLs. Resolve OSF DOI destinations to their targets. All exposed tools are read-only and never perform writes.
- When to use it
- Useful when an assistant needs to look up OSF projects, components, contributors, files, preprints or DOI targets during research or literature-review work, without leaving the chat. Not intended for uploading, deleting or creating OSF content, since the MCP tools are read-only.
- Requirements
- Runs as a local process over stdio, distributed as an OCI image; the underlying CLI requires Go 1.26 or newer if built from source. An OSF account credential is needed: OSF_TOKEN is preferred, with OSF_USERNAME and OSF_PASSWORD as an optional fallback. Network access to the OSF API is required.
Installation
In SourceWeft
- Open OSF CLI Go in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
osf-cli-go
A Go command-line client for the Open Science Framework (OSF).
[CI] [Lint] [Security] [Go Reference] [License] [Go Version] [Release] [OSF CLI Go MCP server]
Features
osf auth whoami— Identify the authenticated OSF accountosf auth login— Guided personal-access-token bootstrap for username/password usersosf projects list|get— List and inspect projectsosf components list— List project componentsosf files list|download|upload|mkdir|rm— Browse, download, upload, create folders, and delete OSF Storage filesosf search,osf search --bibtex,osf preprints list|search, andosf resolve— Search/export OSF literature metadata, discover preprints, and resolve OSF DOI destinationsosf registrations create— Create draft registrations for an existing nodeosf export— Export a node snapshot as JSON or a summary tableosf validate— Check OSF node metadata with deterministic research-output or preregistration profilesosf-mcp— Stdio MCP server exposing read-only OSF tools for agent clientsosf completion bash|zsh|fish|powershell— Shell completion scripts- JSON and human-readable output modes
- Safe, atomic file downloads with conflict policy (fail/skip/overwrite)
Install
Requirements:
- Go 1.26 or newer
Or from a local checkout:
Authentication
Set OSF_TOKEN in your shell session. Do not commit the token or write it into project files. OSF_USERNAME and OSF_PASSWORD are supported as an opt-in fallback credential source, but personal access tokens remain preferred for automation and for accounts using SSO or two-factor authentication.
For guided token setup:
Quick Start
MCP Server
osf-mcp runs a stdio MCP server with read-only tools:
osf_whoami, osf_projects_list, osf_project_get,
osf_components_list, osf_files_list, osf_contributors_list,
osf_search, osf_preprints_list, osf_preprints_search, and
osf_doi_resolve.
The parity discovery tools are bounded and deterministic: osf_search requires
a non-empty query and accepts a limit from 1 to 100, while
osf_preprints_list accepts an optional provider and the same bounded limit.
osf_preprints_search requires a title query, accepts an optional provider, and
returns publication date, published state, DOI, and OSF HTML URL with a limit
from 1 to 100. These tools return structured JSON through the MCP server and
never perform writes.
OSF search results include stable IDs, title, abstract, keywords, year, and URL.
Use osf search <query> --bibtex to emit deterministic BibTeX records for
literature-review workflows. The command does not resolve contributor names or
download PDFs automatically.
For DataLad workflows, OSF CLI Go provides the general-purpose OSF API and
safe file primitives used around a dataset, including osf export and
osf files download --tree. It does not install or configure DataLad, Git
remotes, or git-annex special remotes; those integrations remain a separately
scoped interoperability boundary.
Local development configs are included for GitHub Copilot, VS Code, Claude,
Codex, Gemini CLI, and Qwen Code. Public registry metadata is in server.json
and registry/.
Related MCP Servers
Other maintained servers in the same Glama portfolio:
- FYI MCP for freedom-of-information request workflows.
- Healthpoint MCP for licensed health-service directory data.
- SourceRight for reference and citation verification.
Related OSF ecosystem servers:
- OSF connector by pipeworx-io for hosted OSF connectivity.
- Paperclip for multi-provider scholarly and OSF Preprints search.
Output Modes
All commands support --output table|json and --json shorthand:
Project Status
The CLI is offline-tested for read-only operations, file downloads, WaterButler write primitives, search, preprint listing, draft registration creation, project create/update/delete operations, and node export. All Conductor tracks are reconciled against their per-track plans with closeout review evidence; live OSF validation remains opt-in because it requires credentials and network access.
Documentation
- Release checklist
- Documentation site source
- Install guide
- Usage guide
- Command reference
- Examples
- Architecture
- Developer guide
- MCP roadmap
- Contributing
License
Apache 2.0 — see LICENSE.
Citation
If you use this software in your research, please cite it using the metadata in CITATION.cff.
Source: README.md at commit 61627db
Tools
0Version history
1- v0.3.2LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts