# Tana MCP > Tana MCP lets your AI agent turn natural language conversations into structured knowledge graphs, tackling complex data modeling directly in Tana. Define custom data types (Supertags), build multi-level outlines with specific fields, and connect related ideas using simple prompts. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** graph-database, ontologies, knowledge-graph, supertags, structured-data, personal-knowledge-management ## Description Think of this connector as turning your large language model into a specialized database architect for your personal workspace. Instead of leaving raw text dumps that pile up in your notes app, you program your agent to instantly process thoughts and build proper structure. You can tell it, 'Take these meeting minutes and make sure the action items are checkboxes, tag them as #meeting, and list who owns them.' The system handles mapping those concepts into Tana's underlying graph—creating new nodes, linking related ideas across different documents, or even defining entirely new types of data you use repeatedly. By connecting to Vinkius, your AI agent gets access to this powerful schema management capability, letting you move past manual entry and focus purely on thinking. ## Tools ### add_checkbox_task Creates a simple checklist item or to-do task in your Tana inbox. ### add_date_node Generates a date-typed node, correctly formatted for calendar use, right into the inbox. ### add_node Creates a brand new concept or record in a specified Tana area like your Inbox or Library. ### add_node_reference Builds a link between two existing ideas, showing that one relates directly to the other. ### add_tagged_node Creates a new node and immediately applies a required classification tag (supertag) to it. ### add_to_inbox Quickly drops a brand new, untagged idea directly into the main Tana Inbox area. ### add_url_bookmark Creates a node specifically for a web link (URL), making it easily retrievable in your knowledge graph. ### add_node_with_children Generates a parent concept and automatically populates it with multiple, related sub-nodes underneath. ### add_node_with_fields Creates a highly structured node by requiring you to define its name, supertag, and specific field values using JSON data. ### define_supertag Sets up an entirely new classification category or metadata type (a Supertag) for your Tana workspace. ## Prompt Examples **Prompt:** ``` Add a new conceptual outline to my Inbox. The main title should be 'Quarterly Product Strategy', and it should contain three specific child nodes functioning as checkable tasks. ``` **Response:** ``` Processing graph entry natively... Executing `add_node_with_children` with root name: 'Quarterly Product Strategy'. Child items initialized safely as text nodes temporarily... Converting children to executable tasks sequentially using `add_checkbox_task` targeting the new node parent ID. The workflow is completed synchronously in your Inbox. ``` **Prompt:** ``` Create a new node 'Meeting Notes format' structured in our weekly workspace. ``` **Response:** ``` Compiling cognitive envelope using `create_node`... New node 'Meeting Notes format' instantiated successfully in the weekly workspace. Node ID generated: `node-7bx9`. You can now map sub-nodes or supertags to this base. ``` **Prompt:** ``` Search my Tana knowledge base for nodes tagged with '#project'. ``` **Response:** ``` Querying your graph environment ('search_nodes')... Found 4 operational nodes bearing the `#project` supertag: - 'Website Redesign' - 'Q3 Marketing Push' - 'API Deprecation' - 'Cloud Migration' ``` ## Capabilities ### Create structured knowledge nodes Build new concepts or records in Tana by specifying their name and target location. ### Define custom data types (Supertags) Establish reusable classification schemas so that every time you mention 'Client,' it automatically gets the correct metadata attached. ### Build nested outlines Programmatically create a parent node and populate it with multiple, structured child nodes in one go. ### Reference existing data points Link two separate ideas together to show a direct relationship between them without duplicating information. ### Add specialized content types Instantly generate specific formats, like dates or URL bookmarks, so the data is immediately usable for filtering and sorting. ## Use Cases ### Structuring meeting action items A project manager finished a call and needs the outcomes stored. Instead of pasting everything into a document, they prompt their agent: 'Log these minutes to my inbox, tag them as #meeting, and turn every actionable item into a checkbox task.' The system executes this using `add_tagged_node` and `add_checkbox_task`, delivering an organized record immediately. ### Mapping out research outlines A student is writing a thesis. They ask their agent to 'Create the main outline for Chapter 3, which needs three sub-sections.' The system uses `add_node_with_children` to build the framework and then links relevant sources using `add_node_reference`, creating an interconnected draft structure. ### Logging client onboarding details A sales team member finishes a discovery call. They prompt their agent: 'Create a new Client Profile for Acme Corp.' The MCP uses `add_node_with_fields` to ensure the profile captures mandatory data points like industry, contact person, and deal stage into specific fields. ### Creating reusable templates A team needs a consistent way to log weekly summaries. They prompt: 'Build a template node for Weekly Ops Review.' The system uses `add_node` and pre-populates it with necessary date fields (`add_date_node`) so everyone starts from the same structured base. ## Benefits - Stop writing flat meeting notes. You can tell your agent to build a full outline and automatically transform the subpoints into executable tasks using `add_node_with_children` followed by `add_checkbox_task`. The structure is done instantly. - Never lose track of definitions again. Use `define_supertag` to establish new classification standards for your team, ensuring every record—whether it’s a person or a project—is consistently tagged and searchable. - Build deep relationships between ideas without copy-pasting. By using `add_node_reference`, you create a direct link showing how one concept informs another, making your knowledge graph much richer than simple notes. - It handles specialized data types automatically. Need to log a date or an external source? Use `add_date_node` or `add_url_bookmark` so the node type is correct from the start, preventing manual cleanup later on. - You can build complex records with guaranteed structure by using `add_node_with_fields`. This forces your AI agent to capture not just text, but specific data points like status and owner in a structured format. ## How It Works The bottom line is that you tell your AI what knowledge you want to capture, and this MCP handles turning that messy intent into clean, linked data points in Tana. 1. First, append the Tana matrix module into your Vinkius connective logic workspace. 2. Next, obtain an active TANA API token from your account settings and set its security parameter for use in your environment. 3. Finally, prompt your agent naturally by asking it to structure content: 'Send a structured meeting note to my inbox with the #Agenda supertag, and include three checkbox tasks as its children.' ## Frequently Asked Questions **How do I start with Tana and this MCP?** You first need to add the Tana module in your Vinkius connective logic workspace. Then, you secure an API token from Tana's side and pass that credential into your local environment for the agent to use. **Can I use Tana MCP to build outlines?** Yes. You can generate a parent node and automatically populate it with multiple, structured child nodes using `add_node_with_children`, perfect for outlining strategies or reports. **What if my data needs specific fields like 'Owner'?** You use the `add_node_with_fields` tool. This forces your agent to capture not just text, but also structured values for defined fields (like status or owner) when creating a record. **Is Tana MCP only for linking ideas?** No, it does much more than linking. It allows you to define the fundamental data types themselves by using `define_supertag`, which is key for maintaining system integrity. **How do I make a task list that works with Tana MCP?** You can use `add_checkbox_task` to create a simple checklist item in the inbox. This tool ensures the output is an executable, structured task type.