misskey-mcp-server

What is misskey-mcp-server?

misskey-mcp-server is an unofficial MCP (Model Context Protocol) server for Misskey, currently offering only minimal functionality: posting notes and retrieving notes for a specific user. It is written in Go and built on top of the go-misskey SDK.

How to use misskey-mcp-server?

Install via go install or build from source. Configure your MCP client’s mcp.json by setting the command to misskey-mcp-server and providing the environment variables MISSKEY_API_TOKEN, MISSKEY_PROTOCOL, MISSKEY_DOMAIN, and optionally MISSKEY_PATH.

Key features of misskey-mcp-server

• Post notes to Misskey via the post_misskey_note tool.
• Retrieve a user's notes via the get_misskey_user_notes tool.
• Work in progress with many more planned MCP tools.
• Unofficial, community-driven project.
• Written in Go with the mcp-golang library.

Use cases of misskey-mcp-server

• Post notes to a Misskey instance from an AI assistant or automation tool.
• Fetch recent notes of a given Misskey user programmatically.
• Serve as a foundation for contributors to add missing features.

FAQ from misskey-mcp-server

What can I currently do with misskey-mcp-server?

You can post a note to Misskey using post_misskey_note and get notes of a specific user using get_misskey_user_notes. All other listed tools are not yet implemented.

How do I set up the server?

Add a misskey-mcp-server entry to your MCP client's mcp.json. Set the command to misskey-mcp-server and provide the environment variables MISSKEY_API_TOKEN (from Misskey’s API token page), MISSKEY_PROTOCOL (http or https), MISSKEY_DOMAIN (e.g., misskey.io), and optionally MISSKEY_PATH.

Is this an official Misskey tool?

No, it is an unofficial MCP server created by the community. The README explicitly states it is unofficial.

What are the runtime requirements?

The server is written in Go. You can install it with go install or build it yourself. It uses the go-misskey SDK as a dependency but does not require any runtime beyond the compiled binary.

How can I contribute?

The README welcomes contributions via pull requests. The project maintains a roadmap of unimplemented tools that contributors can help build.