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.

VerifiedSTDIODesktop onlyFiles & StorageKnowledge & Memory

Overview

AI-generated 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.
Before you install
Requires an OSF personal access token or account credentials; keep the token out of project files and commits. The username/password fallback is less suitable for automation and for SSO or two-factor accounts. The MCP tools are read-only, but the accompanying CLI can upload, delete, create registrations and modify projects, so scope what the assistant can run.

Installation

In SourceWeft

  1. Open OSF CLI Go in the dashboard and add it to a workspace.
  2. 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 account
  • osf auth login — Guided personal-access-token bootstrap for username/password users
  • osf projects list|get — List and inspect projects
  • osf components list — List project components
  • osf files list|download|upload|mkdir|rm — Browse, download, upload, create folders, and delete OSF Storage files
  • osf search, osf search --bibtex, osf preprints list|search, and osf resolve — Search/export OSF literature metadata, discover preprints, and resolve OSF DOI destinations
  • osf registrations create — Create draft registrations for an existing node
  • osf export — Export a node snapshot as JSON or a summary table
  • osf validate — Check OSF node metadata with deterministic research-output or preregistration profiles
  • osf-mcp — Stdio MCP server exposing read-only OSF tools for agent clients
  • osf 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
powershell
go install github.com/edithatogo/osf-cli-go/cmd/osf@latestgo install github.com/edithatogo/osf-cli-go/cmd/osf-mcp@latest

Or from a local checkout:

powershell
go build -o bin\osf.exe ./cmd/osfgo build -o bin\osf-mcp.exe ./cmd/osf-mcp.\scripts\build.ps1

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.

powershell
$env:OSF_TOKEN = '<your-token>'

For guided token setup:

powershell
osf auth login

Quick Start

powershell
osf --helposf auth whoamiosf projects listosf projects get https://osf.io/abc12/osf components list abc12osf files list abc12osf files download --file <file-id> ./output/osf files download --tree abc12 ./output/osf files upload --node abc12 ./report.pdfosf search "open science"osf search "open science" --bibtexosf preprints listosf preprints search "open science" --provider osfosf resolve 10.1234/exampleosf registrations create abc12 --schema <schema-id> --title "Analysis plan"osf export abc12 --json

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:

Output Modes

All commands support --output table|json and --json shorthand:

powershell
osf projects list --jsonosf auth whoami --output json

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

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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  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