Summary
The Anytype MCP Server converts Anytype's OpenAPI specification into MCP tools, enabling AI assistants to interact with Anytype's knowledge management platform through natural language commands. It provides capabilities for searching spaces and objects, managing members, creating and organizing objects and lists, and handling properties, tags, types, and templates within Anytype workspaces. The server solves the problem of programmatic access to Anytype's features by allowing users to manage their knowledge base through conversational AI interfaces like Claude, Cursor, and other MCP-compatible clients.
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Tools
Public tool metadata for what this MCP can expose to an agent.
18 tools
get_spacesRetrieves all available Anytype spaces for the current user. This tool returns a list of spaces with their IDs, names, and other metadata. Use this tool to get an overview of all spaces or to find a specific space ID for use with other tools. No parameters are required.
Retrieves all available Anytype spaces for the current user. This tool returns a list of spaces with their IDs, names, and other metadata. Use this tool to get an overview of all spaces or to find a specific space ID for use with other tools. No parameters are required.
No parameter schema in public metadata yet.
get_objectsSearches for and retrieves objects within a specified Anytype space. This tool allows you to list all objects or filter them using a search query. Results are paginated for better performance with large spaces. Use this tool to discover objects within a space, find specific ob...5 params
Searches for and retrieves objects within a specified Anytype space. This tool allows you to list all objects or filter them using a search query. Results are paginated for better performance with large spaces. Use this tool to discover objects within a space, find specific ob...
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
offsetnumberPagination offsetdefault: 0
space_idstringSpace ID to get objects from
include_textbooleanSet to true to include full formatted text content from blocksdefault: false
full_responsebooleanSet to true to get full unfiltered responsedefault: false
get_object_contentRetrieves detailed content and metadata for a specific object in an Anytype space. This tool provides comprehensive information about an object including its properties, relations, and content. Use this tool when you need to examine a specific object's details after discoverin...3 params
Retrieves detailed content and metadata for a specific object in an Anytype space. This tool provides comprehensive information about an object including its properties, relations, and content. Use this tool when you need to examine a specific object's details after discoverin...
Parameters* required
space_idstringSpace ID containing the object
object_idstringObject ID to retrieve
include_textbooleanSet to true to include full formatted text content from blocksdefault: false
create_spaceCreates a new Anytype space with the specified name. This tool allows you to set up a fresh workspace for organizing objects and collaborating with others. Use this tool when you need to establish a new organizational container for your Anytype content.1 params
Creates a new Anytype space with the specified name. This tool allows you to set up a fresh workspace for organizing objects and collaborating with others. Use this tool when you need to establish a new organizational container for your Anytype content.
Parameters* required
namestringName for the new space
create_objectCreates a new object within a specified Anytype space. This tool allows you to add various types of content (pages, notes, tasks, etc.) to your spaces. You can specify the object's name, type, description, icon, and content. Optionally, you can use a template to create pre-str...8 params
Creates a new object within a specified Anytype space. This tool allows you to add various types of content (pages, notes, tasks, etc.) to your spaces. You can specify the object's name, type, description, icon, and content. Optionally, you can use a template to create pre-str...
Parameters* required
bodystringObject body/content (Markdown supported)
iconobjectObject icon details (structure based on API docs)
namestringObject name
sourcestringSource URL (for bookmarks)
space_idstringSpace ID to create the object in
type_keystringType key of object to create (e.g. 'ot-page')
descriptionstringObject's short description
template_idstringTemplate ID to use
delete_objectPermanently removes an object from a specified Anytype space. This tool deletes the object and all its content. Use this tool with caution as deleted objects cannot be recovered. Always verify the object ID before deletion to avoid removing important content.2 params
Permanently removes an object from a specified Anytype space. This tool deletes the object and all its content. Use this tool with caution as deleted objects cannot be recovered. Always verify the object ID before deletion to avoid removing important content.
Parameters* required
space_idstringSpace ID containing the object
object_idstringObject ID to delete
export_objectExports an Anytype object in Markdown format. This tool allows you to extract content from Anytype for use in other applications or for backup purposes. Markdown format is human-readable and suitable for documentation. Use this tool when you need to share Anytype content with...3 params
Exports an Anytype object in Markdown format. This tool allows you to extract content from Anytype for use in other applications or for backup purposes. Markdown format is human-readable and suitable for documentation. Use this tool when you need to share Anytype content with...
Parameters* required
formatstringExport format (currently only 'markdown' is supported)
space_idstringSpace ID containing the object
object_idstringObject ID to export
get_space_membersRetrieves a list of all members who have access to a specified Anytype space. This tool provides information about each member including their ID, name, and access level. Results are paginated for spaces with many members. Use this tool when you need to understand who has acce...3 params
Retrieves a list of all members who have access to a specified Anytype space. This tool provides information about each member including their ID, name, and access level. Results are paginated for spaces with many members. Use this tool when you need to understand who has acce...
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
offsetnumberPagination offsetdefault: 0
space_idstringSpace ID to get members from
get_typesRetrieves all object types available in a specified Anytype space. This tool provides information about the different types of objects that can be created in the space, including their IDs, names, and metadata. Results are paginated for spaces with many types. Use this tool wh...3 params
Retrieves all object types available in a specified Anytype space. This tool provides information about the different types of objects that can be created in the space, including their IDs, names, and metadata. Results are paginated for spaces with many types. Use this tool wh...
Parameters* required
limitnumberNumber of results per page (1-100)default: 100
offsetnumberPagination offsetdefault: 0
space_idstringSpace ID to get types from
get_type_detailsRetrieves detailed information about a specific object type in an Anytype space. This tool provides comprehensive details about the type's structure, including its relations, views, and configuration options. Use this tool when you need to understand the structure of a particu...2 params
Retrieves detailed information about a specific object type in an Anytype space. This tool provides comprehensive details about the type's structure, including its relations, views, and configuration options. Use this tool when you need to understand the structure of a particu...
Parameters* required
type_idstringType ID to retrieve details for
space_idstringSpace ID containing the type
get_templatesRetrieves all available templates for a specific object type in an Anytype space. Templates provide pre-configured structures and content for creating new objects. This tool returns a list of templates with their IDs, names, and metadata. Results are paginated for types with m...4 params
Retrieves all available templates for a specific object type in an Anytype space. Templates provide pre-configured structures and content for creating new objects. This tool returns a list of templates with their IDs, names, and metadata. Results are paginated for types with m...
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
offsetnumberPagination offsetdefault: 0
type_idstringType ID to get templates for
space_idstringSpace ID containing the type
get_template_detailsRetrieves detailed information about a specific template in an Anytype space. This tool provides comprehensive details about the template's structure, content, and configuration. Use this tool when you need to examine a template's properties before using it to create new objec...3 params
Retrieves detailed information about a specific template in an Anytype space. This tool provides comprehensive details about the template's structure, content, and configuration. Use this tool when you need to examine a template's properties before using it to create new objec...
Parameters* required
type_idstringType ID for the template
space_idstringSpace ID containing the template
template_idstringTemplate ID to retrieve details for
get_list_viewsRetrieves views configured for a specific list in a space. Views define how objects in the list are filtered and sorted.4 params
Retrieves views configured for a specific list in a space. Views define how objects in the list are filtered and sorted.
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
offsetnumberPagination offsetdefault: 0
list_idstringList ID to get views for
space_idstringSpace ID containing the list
get_list_view_objectsRetrieves objects from a specific list view with applied filters and sorting.5 params
Retrieves objects from a specific list view with applied filters and sorting.
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
offsetnumberPagination offsetdefault: 0
list_idstringList ID
view_idstringView ID
space_idstringSpace ID containing the list
add_objects_to_listAdds one or more objects to a specific list in a space.3 params
Adds one or more objects to a specific list in a space.
Parameters* required
list_idstringList ID to add objects to
space_idstringSpace ID containing the list
object_idsarrayArray of object IDs to add
remove_object_from_listRemoves an object from a specific list in a space.3 params
Removes an object from a specific list in a space.
Parameters* required
list_idstringList ID to remove object from
space_idstringSpace ID containing the list
object_idstringObject ID to remove
global_searchExecutes a search across all spaces the user has access to, with options for filtering by type and sorting.7 params
Executes a search across all spaces the user has access to, with options for filtering by type and sorting.
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
querystringSearch term
typesarrayOptional list of object type keys or IDs to filter by
offsetnumberPagination offsetdefault: 0
include_textbooleanSet to true to include full formatted text content from blocks. USE WITH CAUTION: This can return a large amount of data.default: false
sort_propertystringProperty to sort byone of
created_date · last_modified_date · last_opened_date · namedefault: last_modified_datesort_directionstringSort directionone of
asc · descdefault: descsearch_spaceExecutes a search within a specific space, with options for filtering by type and sorting.9 params
Executes a search within a specific space, with options for filtering by type and sorting.
Parameters* required
limitnumberNumber of results per page (1-1000)default: 100
querystringSearch term
typesarrayOptional list of object type keys or IDs to filter by
offsetnumberPagination offsetdefault: 0
space_idstringSpace ID to search within
include_textbooleanSet to true to include full formatted text content from blocks. USE WITH CAUTION: This can return a large amount of data.default: false
full_responsebooleanSet to true to get full unfiltered responsedefault: false
sort_propertystringProperty to sort byone of
created_date · last_modified_date · last_opened_date · namedefault: last_modified_datesort_directionstringSort directionone of
asc · descdefault: descAnytype MCP Server
The Anytype MCP Server is a Model Context Protocol (MCP) server enabling AI assistants to seamlessly interact with Anytype's API through natural language.
It bridges the gap between AI and Anytype's powerful features by converting Anytype's OpenAPI specification into MCP tools, allowing you to manage your knowledge base through conversation.
Features
- Global & Space Search
- Spaces & Members
- Objects & Lists
- Properties & Tags
- Types & Templates
Quick Start
1. Get Your API Key
- Open Anytype
- Go to App Settings
- Navigate to API Keys section
- Click on
Create newbutton
Alternative: Get API key via CLI
You can also get your API key using the command line:
npx -y @anyproto/anytype-mcp get-key
2. Configure Your MCP Client
Claude Desktop, Cursor, Windsurf, Raycast, etc.
Add the following configuration to your MCP client settings after replacing <YOUR_API_KEY> with your actual API key:
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": ["-y", "@anyproto/anytype-mcp"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}
Tip: After creating an API key in Anytype, you can copy that ready-to-use configuration snippet with your API key already filled in from the API Keys section.
Claude Code (CLI)
Run this command to add the Anytype MCP server after replacing <YOUR_API_KEY> with your actual API key:
claude mcp add anytype -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' -s user -- npx -y @anyproto/anytype-mcp
Alternative: Global Installation
If you prefer to install the package globally:
- Install the package:
npm install -g @anyproto/anytype-mcp
- Update your MCP client configuration to use the global installation:
{
"mcpServers": {
"anytype": {
"command": "anytype-mcp",
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}
Custom API Base URL
By default, the server connects to http://127.0.0.1:31009. For anytype-cli (port 31012) or other custom base URLs, set ANYTYPE_API_BASE_URL:
Example Configuration
MCP Client (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": ["-y", "@anyproto/anytype-mcp"],
"env": {
"ANYTYPE_API_BASE_URL": "http://localhost:31012",
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}
Claude Code (CLI):
claude mcp add anytype \
-e ANYTYPE_API_BASE_URL='http://localhost:31012' \
-e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' \
-s user -- npx -y @anyproto/anytype-mcp
Example Interactions
Here are some examples of how you can interact with your Anytype:
- "Create a new space called 'Project Ideas' with description 'A space for storing project ideas'"
- "Add a new object of type 'Task' with title 'Research AI trends' to the 'Project Ideas' space"
- "Create a second one with title 'Dive deep into LLMs' with due date in 3 days and assign it to me"
- "Now create a collection with the title "Tasks for this week" and add the two tasks to that list. Set due date of the first one to 10 days from now"
Development
Installation from Source
- Clone the repository:
git clone https://github.com/anyproto/anytype-mcp.git
cd anytype-mcp
- Install dependencies:
npm install -D
- Build the project:
npm run build
- Link the package globally (optional):
npm link
Contribution
Thank you for your desire to develop Anytype together!
❤️ This project and everyone involved in it is governed by the Code of Conduct.
🧑💻 Check out our contributing guide to learn about asking questions, creating issues, or submitting pull requests.
🫢 For security findings, please email security@anytype.io and refer to our security guide for more information.
🤝 Follow us on Github and join the Contributors Community.
Made by Any — a Swiss association 🇨🇭
Licensed under MIT.
Featured
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Configuration
OPENAPI_MCP_HEADERS*secretJSON string of headers for Anytype API. Example: {"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-05-20"}
Categories
Registryactive
Package@anyproto/anytype-mcp
TransportSTDIO
AuthRequired
UpdatedSep 17, 2025
