ExecuFunction MCP Server

A Model Context Protocol server that exposes ExecuFunction tools to IDE clients like Cursor, Claude Desktop, and VS Code.

Quick Start

1. Create a Personal Access Token

1. Go to ExecuFunction → Settings → Developer → Access Tokens
2. Click "Create Token"
3. Name it (e.g., "Cursor MCP")
4. Select scopes: mcp:* (or specific scopes like projects:read, tasks:write)
5. Save the token immediately - it's only shown once!

2. Configure Your MCP Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "execufunction": {
      "command": "npx",
      "args": ["@execufunction/mcp-server"],
      "env": {
        "EXF_API_URL": "https://execufunction.com",
        "EXF_PAT": "exf_pat_your_token_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "execufunction": {
    "command": "npx",
    "args": ["@execufunction/mcp-server"],
    "env": {
      "EXF_API_URL": "https://execufunction.com",
      "EXF_PAT": "exf_pat_your_token_here"
    }
  }
}

VS Code

Configure in your MCP extension settings.

3. Restart Your IDE

After configuration, restart your IDE to load the MCP server.

Available Tools

Projects

| Tool | Description | Mutates | |------|-------------|---------| | project_list | List all projects with status filtering | No | | project_create | Create a new project | Yes | | project_update | Update project name, summary, status, emoji | Yes | | project_archive | Archive a project (destructive) | Yes | | project_get_context | Get full project context (tasks, notes, signals) | No |

Tasks

| Tool | Description | Mutates | |------|-------------|---------| | task_list | List tasks with project/status/phase/effort filters | No | | task_get | Get a single task with full details | No | | task_create | Create a new task with priority, phase, effort, acceptance criteria | Yes | | task_update | Update task fields (title, status, priority, phase, effort, scope) | Yes | | task_delete | Delete a task (destructive) | Yes | | task_complete | Mark a task as complete | Yes | | task_link_code | Link a task to a code file/commit | Yes |

Knowledge / Notes

| Tool | Description | Mutates | |------|-------------|---------| | note_list | List notes with type and project filters | No | | note_get | Get a single note with full content | No | | note_search | Semantic search across knowledge base | No | | note_create | Create a new note (markdown) | Yes | | note_update | Update note title, content, or type | Yes | | note_delete | Delete a note (destructive) | Yes |

People

| Tool | Description | Mutates | |------|-------------|---------| | people_search | Search contacts | No |

Calendar

| Tool | Description | Mutates | |------|-------------|---------| | calendar_list_events | List calendar events for a date range | No | | calendar_create_event | Create a new calendar event | Yes | | calendar_update_event | Update a calendar event | Yes | | calendar_delete_event | Delete a calendar event (destructive) | Yes |

Codebase Indexing

| Tool | Description | Mutates | |------|-------------|---------| | codebase_list | List indexed repositories | No | | codebase_register | Register a new repository for indexing | Yes | | codebase_status | Check indexing status and stats | No | | codebase_snapshot_status | Get latest index snapshot for a repository | No | | codebase_materialize_snapshot | Download a snapshot archive | No | | codebase_index | Full index: scan and upload all files | Yes | | codebase_index_incremental | Incremental index: git-aware, changed files only | Yes | | codebase_delete | Delete a repository and all indexed data (destructive) | Yes | | codebase_search | Semantic search across indexed code | No |

Code History & Expertise

| Tool | Description | Mutates | |------|-------------|---------| | code_who_knows | Find experts for a code area | No | | code_compute_expertise | Refresh the expertise index | Yes | | code_history | Get commit history for a repository | No | | git_blame_symbol | Run git blame on a local file range | No |

Code Memories

| Tool | Description | Mutates | |------|-------------|---------| | code_memory_store | Store a fact about the codebase | Yes | | code_memory_search | Search stored code facts | No | | code_memory_list | List all stored code memories | No | | code_memory_delete | Delete a code memory (destructive) | Yes |

Vault / Secrets

| Tool | Description | Mutates | |------|-------------|---------| | vault_list | List vault entries (metadata only) | No | | vault_create | Store a new encrypted secret | Yes | | vault_read | Decrypt and read a secret (audit-logged) | No | | vault_update | Update vault entry metadata | Yes | | vault_search | Search vault entries by name/description | No |

Entity Graph

| Tool | Description | Mutates | |------|-------------|---------| | entity_graph | Traverse the entity relationship graph | No | | schema_introspect | Discover the full data model and entity types | No |

Document Upload

| Tool | Description | Mutates | |------|-------------|---------| | upload_document | Upload a PDF, Markdown, or text file into Knowledge | Yes |

Datasets (feature flag: DATASETS_ENABLED=true)

| Tool | Description | Mutates | |------|-------------|---------| | dataset_list | List datasets | No | | dataset_create | Create a dataset | Yes | | dataset_query | Query records by filters/sorts | No | | dataset_mutate | Create/update/delete records (destructive) | Yes | | dataset_schema_modify | Add/update/delete fields (destructive) | Yes | | dataset_summarize | Summarize schema and sample rows | No | | dataset_facets | Value distributions for fields | No | | dataset_quality_check | Null rates, duplicates, uniqueness violations | No | | dataset_aggregate | Grouped metrics (count, avg, sum, etc.) | No | | dataset_bucket | Bucket numeric/date fields into ranges | No | | dataset_rank | Rank records by sorts or weighted formula | No | | dataset_analyze | Generate natural-language insights | No | | dataset_compare | Compare metrics across segments | No | | dataset_export | Export records as CSV | No | | dataset_join_rows | Self-join with alias-scoped fields | No | | dataset_compute_fields | Compute derived columns (lag, diff, rolling) | No | | dataset_timeseries | Time series analysis with transforms | No | | dataset_materialize_result | Save derived result as a new dataset | Yes | | dataset_plot_result | Validate chart payload from derived result | No |

Ontology (feature flag: DATASET_ONTOLOGY_ENABLED=true)

| Tool | Description | Mutates | |------|-------------|---------| | object_find | Find objects by type and property filters | No | | object_links | Traverse graph links for an object | No | | object_action_run | Run a declarative action on an object (destructive) | Yes |

Usage Examples

1. Get project context and create a task

User prompt: "Get context for my auth project and create a task to fix the token refresh bug"

Tools invoked:

1. project_list — Lists projects to find the auth project
2. project_get_context — Retrieves tasks, notes, and signals for the project
3. task_create — Creates a new task with title, description, and project linkage

Result: The AI reads existing project context (open tasks, recent notes) to avoid duplicates, then creates a well-scoped task linked to the correct project.

2. Semantic code search

User prompt: "Find where we handle webhook signature verification"

Tools invoked:

1. codebase_search — Searches indexed code for "webhook signature verification"

Result: Returns ranked code chunks with file paths, line numbers, and surrounding context. The AI can then read the matched files to answer follow-up questions.

3. Knowledge search and note creation

User prompt: "Search for our deployment process and create a note summarizing the steps"

Tools invoked:

1. note_search — Searches the knowledge base for "deployment process"
2. code_memory_search — Searches stored code facts for deployment-related memories
3. note_create — Creates a new note with a markdown summary of the deployment steps

Result: The AI synthesizes information from existing notes and code memories into a single reference note, linked to the relevant project.

Resources

The server also exposes project context bundles as MCP resources:

• exf://projects/{id}/context - Full context bundle for a project

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EXF_API_URL | Yes | ExecuFunction API URL | | EXF_PAT | Yes | Personal Access Token |

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspect

# Build for production
npm run build

Security

• PATs are stored as SHA-256 hashes - plaintext is never stored
• Tokens can be revoked at any time from ExecuFunction Settings
• Use minimal scopes for your use case
• Never commit tokens to version control

Scopes

| Scope | Description | |-------|-------------| | mcp:* | All MCP operations (recommended for IDE use) | | projects:read | Read project data | | projects:write | Create/update projects | | tasks:read | Read tasks | | tasks:write | Create/update/complete tasks | | knowledge:read | Search/read notes | | knowledge:write | Create notes | | calendar:read | View calendar/free slots | | calendar:write | Create calendar events | | people:read | Search/view contacts | | people:write | Create/update contacts |

Troubleshooting

"EXF_API_URL environment variable is required"

Make sure you've configured the env section in your MCP client config.

"Invalid token"

1. Check that your token starts with exf_pat_
2. Verify the token hasn't been revoked
3. Check the token hasn't expired

Tools not appearing

1. Restart your IDE after configuration changes
2. Check IDE logs for MCP errors
3. Try running npm run inspect to test the server directly

License

MIT