misskey

misskey-mcp-server is an unofficial MCP (Model Context Protocol) server for Misskey. It currently implements the bare minimum functionality: the ability to post notes to Misskey using the MCP tool post_misskey_note and to fetch notes of a user via get_misskey_user_notes. The server is configured via an mcp.json file under the mcpServers section; for each server you provide a name, the executable, and environment variables that point to your Misskey instance. To use it, set MISSKEY_API_TOKEN, MISSKEY_PROTOCOL, MISSKEY_DOMAIN, and optionally MISSKEY_PATH, then start the binary. Once running, you can invoke the MCP tools supported by this server, such as posting a Misskey note to create content or retrieving a specific user's notes, according to the MCP protocol you’re consuming.

Prerequisites:

• Go toolchain installed (Go 1.20+ recommended)
• Access to a Misskey instance and a valid API token

Installation steps:

1. Install the server binary directly from source:

GOBIN="$HOME/go/bin" go install github.com/ganyariya/misskey-mcp-server/cmd/misskey-mcp-server@latest

2. Build from source manually (optional):

git clone https://github.com/ganyariya/misskey-mcp-server
cd misskey-mcp-server
go build -o misskey-mcp-server cmd/misskey-mcp-server/main.go

3. Prepare your configuration file (mcp.json) with the appropriate environment variables as shown below and run the binary:

{
  "mcpServers": {
    "misskey-mcp-server": {
      "command": "misskey-mcp-server",
      "args": [],
      "env": {
        "MISSKEY_API_TOKEN": "your_api_token_here",
        "MISSKEY_PROTOCOL": "https",
        "MISSKEY_DOMAIN": "your Misskey domain",
        "MISSKEY_PATH": ""
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

4. Run the server:

./misskey-mcp-server

Tips and notes:

• The Misskey API token must have permissions suitable for posting notes and reading user notes (per Misskey API docs).
• MISSKEY_PATH is optional; leave empty if your Misskey instance is at the root. Use it if your instance serves API paths under a subpath.
• The current MCP feature set is limited to posting notes and fetching notes for a user. If you need more endpoints, consider contributing to extend which MCP tools are supported.
• If you encounter CORS or network errors, verify that MISSKEY_DOMAIN and MISSKEY_PROTOCOL correctly point to your Misskey instance and that the API token is valid.
• When upgrading, re-check the environment variable definitions as Misskey API requirements may evolve.